home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 003 / dbedit10.arc / DBEDIT.DOC < prev   
Encoding:
Text File  |  1986-03-02  |  5.3 KB  |  111 lines
  1. DBEDIT.COM
  2. Version 1.00
  3. Wes Davis, 2/86
  4.  
  5.  
  6.  
  7. DBEDIT.COM is a command line editor for dBASE III.  It allows more
  8. flexible editing than dBASE's line editor and provides the ability to
  9. recall the last few commands for editing and re-execution.  DBEDIT
  10. serves the same function for dBASE that DOSEDIT does for DOS.  In fact,
  11. the similarity to DOSEDIT is intentional, and the edit key functions of
  12. DBEDIT are nearly identical to DOSEDIT's.
  13.  
  14. DBEDIT was originally written to function with dBASE III.  Users of
  15. dBASE III+ will not need DBEDIT, because the history command provides
  16. the same function.  DBEDIT has been tested with dBASE III version 1.  I
  17. purchased my copy of dBASE III Prolocked and it has had the Prolock
  18. code removed, but I believe that DBEDIT will work with all of the copy
  19. protected versions of dBASE.  Only a color graphics adapter and color
  20. monitor have been tested.
  21.  
  22. DBEDIT's command holding buffer is 2k bytes.  Commands are stored in the
  23. buffer at the current buffer pointer position.  The current buffer
  24. position is after the last entered command, unless the buffer movement
  25. control(up arrow or down arrow) is used.  These keys leave the buffer
  26. pointer positioned before the displayed command.  Before each command
  27. is entered into the buffer, the buffer is packed to free the maximum
  28. space and delay overwriting saved commands.  It is possible to insert
  29. commands between previously entered commands.  If no change is made to
  30. a command, it is not duplicated into the holding buffer.
  31.  
  32. To use DBEDIT, type DBEDIT at the command prompt after setting the
  33. default directory to the directory that contains DBASE.EXE.  DBEDIT
  34. will load and execute dBASE, remaining resident only during dBASE's
  35. execution.  Command line arguments can be given to DBEDIT just as if it
  36. were dBASE, and the command line will be passed to dBASE.
  37.  
  38. Invoking the program can be made seamless to the casual user by
  39. renaming it DBASE.COM.  DBEDIT will be then started by typing DBASE at
  40. the DOS prompt.  Because DOS will load a .COM program preferentially to
  41. a program with any other extention, DBEDIT will be loaded and then will
  42. load DBASE.EXE and execute it.
  43.  
  44. After DBEDIT loads and starts dBASE, there will be no difference in the
  45. appearance of the screen, but at the dBASE prompt (". ") it will be
  46. possible edit the command more easily.  The following keys will become
  47. active:
  48.  
  49.   home            moves cursor to beginning of line
  50.   end            moves cursor to end of line
  51.   left arrow        moves cursor one space left
  52.   right arrow        moves cursor one space right
  53.   escape        clears the line
  54.   ctrl home        deletes from cursor to the beginning of the line
  55.   ctrl end        deletes from the cursor to the end of the line
  56.   ctrl left arrow    moves to the beginning of the previous word
  57.   ctrl right arrow    moves to the beginning of the next word
  58.   backspace        deletes the character to the left of the cursor
  59.   delete        deletes the character at the cursor
  60.   ins    toggles     insert/overwrite mode
  61.   up arrow        moves backward in the command holding buffer
  62.   down arrow        moves forward in the command holding buffer
  63.   ctrl PgDn        removes displayed command from the holding buffer
  64.   ctrl PgUp        clears the holding buffer
  65.   alt=            enters/exits full screen buffer edit mode (CGA only)
  66.   ctrl enter        exits alt= mode and submits command to dBASE
  67.   ctrl S        deletes the character to the left of the cursor
  68.   ctrl U        clears the line
  69.   ctrl X        clears the line
  70.  
  71.  
  72. Alt= mode is invoked by the alt= key.  The same key combination exits
  73. alt= mode and returns to the dBASE screen.  Alt= mode is available only
  74. on systems equipped with a color graphics adapter.  When invoked, it
  75. presents the command holding buffer and allows the use of the editing
  76. keys to modify the commands stored in the buffer.  The buffer is
  77. circular and if the cursor is moved up, the next command in the buffer
  78. is displayed, even if it is already displayed at the bottom of the
  79. screen.  When the enter key is struck in this mode, the current line is
  80. entered into the buffer (if it has been altered) but the command is not
  81. submitted to dBASE.  The ctrl enter key will exit alt= mode and submit
  82. the current command to dBASE.  The ctrl enter has the same effect as
  83. enter in normal mode.
  84.  
  85.  
  86. The use of the function keys is unaffected.
  87.  
  88. Command lines of up to 252 characters are possible.  Only eighty
  89. characters will be displayed, with the remainder of the line scrolled
  90. off the display to the left or the right.  When the command is returned
  91. to dBASE (enter key), dBASE will wrap the line and may generate several
  92. lines.
  93.  
  94. If DBEDIT.COM is in the DBASE default directory,  the command holding
  95. buffer will be stored upon exit from dBASE.  When DBEDIT is next
  96. executed, the commands will be restored to the buffer.
  97.  
  98.  
  99. Caution:
  100. DBEDIT recognizes that dBASE is in command entry mode by the ". "
  101. prompt that dBASE uses.  If the prompt is changed, DBEDIT cannot figure
  102. out that dBASE is in command entry mode, and will not become active.
  103. For the same reason, displaying a "." in column 1 and a space in column
  104. 2, then positioning the cursor in column 3 and reading a character will
  105. fool DBEDIT into becoming active.  This will hopefully not be a serious
  106. problem, but I am warning you now.
  107.  
  108.  
  109. I can be reached on the Atlanta bulletin boards PC Forum (404 294-0237) or
  110. PCUG (404 433-0062).
  111.